Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 2 - 3D Viewer / 3D Viewer Reference

3D Viewer Routines / Creating and Configuring Viewers

Q3ViewerNew

You can use the Q3ViewerNew function to create a new viewer object.

TQ3ViewerObject Q3ViewerNew (
CGrafPtr port, 
Rect *rect, 
unsigned long flags);

port

A pointer to a color graphics port that specifies the window with which the new viewer is to be associated.

rect

The desired viewer pane for the new viewer object. This rectangle is specified in window coordinates, where the origin (0, 0) is the upper-left corner of the window and values increase to the right and down the window.

flags

A set of viewer flags.

DESCRIPTION

The Q3ViewerNew function returns, as its function result, a reference to a new viewer object that is to be drawn in the window specified by the port parameter, in the location specified by the rect parameter. The flags parameter specifies the desired set of viewer flags. See "Viewer Flags" on page 2-12 for information on the flags you can specify when calling Q3ViewerNew.

The Q3ViewerNew function calls the QuickDraw 3D function Q3Initialize if your application has not already called it.